home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_include / LINUX / LP.H < prev    next >
C/C++ Source or Header  |  1999-09-17  |  6KB  |  185 lines
  1. #ifndef _LINUX_LP_H
  2. #define _LINUX_LP_H
  3.  
  4. /*
  5.  * usr/include/linux/lp.h c.1991-1992 James Wiegand
  6.  * many modifications copyright (C) 1992 Michael K. Johnson
  7.  * Interrupt support added 1993 Nigel Gamble
  8.  */
  9.  
  10. /* Magic numbers for defining port-device mappings */
  11. #define LP_PARPORT_UNSPEC -4
  12. #define LP_PARPORT_AUTO -3
  13. #define LP_PARPORT_OFF -2
  14. #define LP_PARPORT_NONE -1
  15.  
  16. /*
  17.  * Per POSIX guidelines, this module reserves the LP and lp prefixes
  18.  * These are the lp_table[minor].flags flags...
  19.  */
  20. #define LP_EXIST 0x0001
  21. #define LP_SELEC 0x0002
  22. #define LP_BUSY     0x0004
  23. #define LP_BUSY_BIT_POS 2
  24. #define LP_OFFL     0x0008
  25. #define LP_NOPA  0x0010
  26. #define LP_ERR   0x0020
  27. #define LP_ABORT 0x0040
  28. #define LP_CAREFUL 0x0080 /* obsoleted -arca */
  29. #define LP_ABORTOPEN 0x0100
  30. #define    LP_TRUST_IRQ 0x0200
  31.  
  32. /* timeout for each character.  This is relative to bus cycles -- it
  33.  * is the count in a busy loop.  THIS IS THE VALUE TO CHANGE if you
  34.  * have extremely slow printing, or if the machine seems to slow down
  35.  * a lot when you print.  If you have slow printing, increase this
  36.  * number and recompile, and if your system gets bogged down, decrease
  37.  * this number.  This can be changed with the tunelp(8) command as well.
  38.  */
  39.  
  40. #define LP_INIT_CHAR 1000
  41.  
  42. /* The parallel port specs apparently say that there needs to be
  43.  * a .5usec wait before and after the strobe.
  44.  */
  45.  
  46. #define LP_INIT_WAIT 1
  47.  
  48. /* This is the amount of time that the driver waits for the printer to
  49.  * catch up when the printer's buffer appears to be filled.  If you
  50.  * want to tune this and have a fast printer (i.e. HPIIIP), decrease
  51.  * this number, and if you have a slow printer, increase this number.
  52.  * This is in hundredths of a second, the default 2 being .05 second.
  53.  * Or use the tunelp(8) command, which is especially nice if you want
  54.  * change back and forth between character and graphics printing, which
  55.  * are wildly different...
  56.  */
  57.  
  58. #define LP_INIT_TIME 2
  59.  
  60. /* IOCTL numbers */
  61. #define LPCHAR   0x0601  /* corresponds to LP_INIT_CHAR */
  62. #define LPTIME   0x0602  /* corresponds to LP_INIT_TIME */
  63. #define LPABORT  0x0604  /* call with TRUE arg to abort on error,
  64.                 FALSE to retry.  Default is retry.  */
  65. #define LPSETIRQ 0x0605  /* call with new IRQ number,
  66.                 or 0 for polling (no IRQ) */
  67. #define LPGETIRQ 0x0606  /* get the current IRQ number */
  68. #define LPWAIT   0x0608  /* corresponds to LP_INIT_WAIT */
  69. /* NOTE: LPCAREFUL is obsoleted and it' s always the default right now -arca */
  70. #define LPCAREFUL   0x0609  /* call with TRUE arg to require out-of-paper, off-
  71.                 line, and error indicators good on all writes,
  72.                 FALSE to ignore them.  Default is ignore. */
  73. #define LPABORTOPEN 0x060a  /* call with TRUE arg to abort open() on error,
  74.                 FALSE to ignore error.  Default is ignore.  */
  75. #define LPGETSTATUS 0x060b  /* return LP_S(minor) */
  76. #define LPRESET     0x060c  /* reset printer */
  77. #ifdef LP_STATS
  78. #define LPGETSTATS  0x060d  /* get statistics (struct lp_stats) */
  79. #endif
  80. #define LPGETFLAGS  0x060e  /* get status flags */
  81. #define LPTRUSTIRQ  0x060f  /* set/unset the LP_TRUST_IRQ flag */
  82.  
  83. /* timeout for printk'ing a timeout, in jiffies (100ths of a second).
  84.    This is also used for re-checking error conditions if LP_ABORT is
  85.    not set.  This is the default behavior. */
  86.  
  87. #define LP_TIMEOUT_INTERRUPT    (60 * HZ)
  88. #define LP_TIMEOUT_POLLED    (10 * HZ)
  89.  
  90. #define LP_F(minor)    lp_table[(minor)].flags        /* flags for busy, etc. */
  91. #define LP_CHAR(minor)    lp_table[(minor)].chars        /* busy timeout */
  92. #define LP_TIME(minor)    lp_table[(minor)].time        /* wait time */
  93. #define LP_WAIT(minor)    lp_table[(minor)].wait        /* strobe wait */
  94. #define LP_IRQ(minor)    lp_table[(minor)].dev->port->irq /* interrupt # */
  95.                     /* PARPORT_IRQ_NONE means polled */
  96. #ifdef LP_STATS
  97. #define LP_STAT(minor)    lp_table[(minor)].stats        /* statistics area */
  98. #endif
  99. #define LP_BUFFER_SIZE 256
  100.  
  101. #define LP_BASE(x)    lp_table[(x)].dev->port->base
  102.  
  103. #ifdef LP_STATS
  104. struct lp_stats {
  105.     unsigned long chars;
  106.     unsigned long sleeps;
  107.     unsigned int maxrun;
  108.     unsigned int maxwait;
  109.     unsigned int meanwait;
  110.     unsigned int mdev;
  111. };
  112. #endif
  113.  
  114. struct lp_struct {
  115.     struct pardevice *dev;
  116.     unsigned long flags;
  117.     unsigned int chars;
  118.     unsigned int time;
  119.     unsigned int wait;
  120.     char *lp_buffer;
  121. #ifdef LP_STATS
  122.     unsigned int lastcall;
  123.     unsigned int runchars;
  124.     struct lp_stats stats;
  125. #endif
  126.     struct wait_queue *wait_q;
  127.     unsigned int last_error;
  128.     volatile unsigned int irq_detected:1;
  129.     volatile unsigned int irq_missed:1;
  130. };
  131.  
  132. /*
  133.  * The following constants describe the various signals of the printer port
  134.  * hardware.  Note that the hardware inverts some signals and that some
  135.  * signals are active low.  An example is LP_STROBE, which must be programmed
  136.  * with 1 for being active and 0 for being inactive, because the strobe signal
  137.  * gets inverted, but it is also active low.
  138.  */
  139.  
  140. /* 
  141.  * bit defines for 8255 status port
  142.  * base + 1
  143.  * accessed with LP_S(minor), which gets the byte...
  144.  */
  145. #define LP_PBUSY    0x80  /* inverted input, active high */
  146. #define LP_PACK        0x40  /* unchanged input, active low */
  147. #define LP_POUTPA    0x20  /* unchanged input, active high */
  148. #define LP_PSELECD    0x10  /* unchanged input, active high */
  149. #define LP_PERRORP    0x08  /* unchanged input, active low */
  150.  
  151. /* 
  152.  * defines for 8255 control port
  153.  * base + 2 
  154.  * accessed with LP_C(minor)
  155.  */
  156. #define LP_PINTEN    0x10  /* high to read data in or-ed with data out */
  157. #define LP_PSELECP    0x08  /* inverted output, active low */
  158. #define LP_PINITP    0x04  /* unchanged output, active low */
  159. #define LP_PAUTOLF    0x02  /* inverted output, active low */
  160. #define LP_PSTROBE    0x01  /* short high output on raising edge */
  161.  
  162. /* 
  163.  * the value written to ports to test existence. PC-style ports will 
  164.  * return the value written. AT-style ports will return 0. so why not
  165.  * make them the same ? 
  166.  */
  167. #define LP_DUMMY    0x00
  168.  
  169. /*
  170.  * This is the port delay time, in microseconds.
  171.  * It is used only in the lp_init() and lp_reset() routine.
  172.  */
  173. #define LP_DELAY     50
  174.  
  175. #define LP_POLLED(minor) (lp_table[(minor)].dev->port->irq == PARPORT_IRQ_NONE)
  176. #define LP_PREEMPTED(minor) (lp_table[(minor)].dev->port->waithead != NULL)
  177.  
  178. /*
  179.  * function prototypes
  180.  */
  181.  
  182. extern int lp_init(void);
  183.  
  184. #endif
  185.